home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
User's Choice Windows CD
/
User's Choice Windows CD (CMS Software)(1993).iso
/
win_m_p
/
pwez51.zip
/
QUICKREF.DOC
< prev
next >
Wrap
Text File
|
1992-04-01
|
22KB
|
791 lines
Quick Reference Guide
For use with WINDOWS R-E-Z
QuickBasic 4.++ and BASIC 7.+ (PDS)
Version 5.10
Copyright (c) 1988 - 1992 by:
CONNECT Software
All rights reserved
( See WIND_REZ.DOC for details. )
( All routines are sub-routines unless noted otherwise. )
=====================================================================
Window Management System
=====================================================================
CHNGWIND (W%)
Changes the active window to a new window.
W% is the new active window number. ( 1 to 20 )
--------------------------------------------------------------------
CLRWIND
Clears the interior of the active window.
--------------------------------------------------------------------
DELWIND (W%)
Deletes a saved window from window memory.
W% is the window number to delete. ( 1 to 20 )
--------------------------------------------------------------------
LINEW (ROW%, TYP%)
Prints, or erases, a horizontal line in the active window.
ROW% is the row in the window in which the line will print.
TYP% = 1 for single line, 2 for double line, 0 to erase a line.
--------------------------------------------------------------------
MAKEWIND (W%, TITLE$, TR%, LC%, WD%, NR%, ATTR%, BORD%)
Makes a window and optionally saves a windowed area.
W% is the assigned window number. ( 0 to 20 ) "0" is not saved.
TITLE$ is the window's title.
TR% is the window's top row. ( 1 to 23 or 100 )
LC% is the window's left column. ( 1 to 78 or 100 )
WD% is the window's width. ( 3 to 80 )
NR% is the number of rows. ( 3 to 25 )
ATTR% is the window's color designation. ( 0 to 255 )
BRDR% is the border designation. (0-2, 10-12, 20-22, 30-32,
40-42, 100-102, 110-112, 120-122, 130-132, 140-142 )
--------------------------------------------------------------------
NEWCOLOR (ATTR%)
Changes the "print-to" color of the active window.
ATTR% is the new "print-to" color. ( 0 to 255 )
--------------------------------------------------------------------
PRINTW (TEXT$, ROW%, COL%)
Prints text in the active window.
TEXT$ is the text to print in the active window.
ROW% is the row in the window in which the text will print.
COL% is the column in the window where the text print starts .
--------------------------------------------------------------------
1
Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
=====================================================================
Window Management System - Cont.
=====================================================================
RESAVE
Saves the active window and interior of same in window memory.
Replaces the area covered by the active window in window memory.
--------------------------------------------------------------------
RSTRWIND (W%, DELFLAG%)
Restores a window from window memory to the display.
W% is the window number to restore. ( 1 to 20 )
DELFLAG% = 1 to remove the window (W%) from window memory.
0 to leave the window (W%) in window memory.
--------------------------------------------------------------------
SAVEWIND (W%, TR%, LC%, WD%, NR%)
Saves an area from the display to window memory.
W% is the window area's assigned number. ( 1 to 20 )
TR% is the top row. ( 1 to 23 or 100 )
LC% is the left column. ( 1 to 78 or 100 )
WD% is the width. ( 3 to 80 )
NR% is the number of rows. ( 3 to 25 )
--------------------------------------------------------------------
SETWIND (FAST%, SND%, SHAD%)
Sets window memory, sound, and display update speed.
FAST% = 1 for fast screen updates, 0 for slow CGA screen updates.
SND% = 1 for "click", 2 for "beep", and 0 for no sound.
SHAD% is the window shadow color. ( 0 to 255 )
--------------------------------------------------------------------
WAVAIL% (WINDOW%) *** FUNCTION ***
Returns 1 if a window is availaible, 0 if it is not available.
WINDOW% is the window number. ( 1 to 25 )
--------------------------------------------------------------------
WINDSTATUS
Display the status of windows saved in window memory.
--------------------------------------------------------------------
2
Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
=====================================================================
Pulldown Windows
=====================================================================
CHNGPULL (BARITEM%, WINDITEM%, ATTR%)
Makes a pulldown window selection active or inactive.
BARITEM% is the number of the pulldown menu bar selection.
WINDITEM% is the number of the pulldown window selection.
ATTR% = 0 for active selection with original color.
1 to 127 for inactive selection with new color.
--------------------------------------------------------------------
SETPULL (TR%, LC%, WD%, PWIND$() )
Set up routine for pulldown windows
TR% is the top row of the menubar. ( 1 to 21 )
LC% is the left column position of the menubar. ( 1 to 73 )
WD% the menubar's width. ( Maximum of 81 - LC% )
PWIND$() is the array holding the data for the pulldown menubar,
menubar's info-line, and pulldown window's selections.
--------------------------------------------------------------------
PULLDOWN (INFO$(),MENUBAR%,WINDITEM%,EXIT$,RKEY%,ATTR%,KEYATTR%,BRDR%)
Places user in the pulldown window environment.
INFO$() holds the pulldown window's selections info-line data.
MENUBAR% is the selected menu bar item.
WINDITEM% is the selected pulldown window item.
EXIT$ sets the exit keys.
RKEY% represents the key pressed, which caused the exit.
ATTR% is the color for the pulldown windows. ( 1 to 127 )
KEYATTR% is the color for the key characters. ( 1 to 127 )
BRDR% is the border designation. ( 0,1,2,10,11,12)
--------------------------------------------------------------------
RSTRPULL ( RSTRMENUBAR% )
Deactivates the active pulldown window. Restores the display
area under the active pulldown window, optionally restoring
the area under the menubar also.
RSTRMENUBAR% is set to 1 to restore the display area under
the menubar, 0 does not restore the area.
--------------------------------------------------------------------
3
Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
=====================================================================
Scroll Windows
=====================================================================
MARKED% (RTRN$, START%) *** FUNCTION ***
Decodes marked items from a "mark" scroll window.
RTRN$ is the string representing items marked in a scroll window.
START% is the position in which to start the decoding in RTRN$.
--------------------------------------------------------------------
SETSCRL (ISARROW%, NOHI%, TAGCOLOR%)
Changes default settings for calls to routine SCRLWIND.
ISARROW% = 1 for direction arrow, 0 for no direction arrow.
NOHI% = 0 to display high intensity characters normally.
1 to display as inverse video for PULLDOWN & SCRLWIND.
TAGCOLOR% sets the color for the "mark" arrow. (0 to 15)
--------------------------------------------------------------------
SCRLWIND (LIST$(),INFO$(),TL$,ENTRIES%,KIND$,RTRN%,LI%,FC%,RKEY%,
KEYATTR%)
Note: The above call to SCRLWIND must be typed one line in the
QB/QBX environment.
Places a scrollable list in a window previously made by MAKEWIND.
LIST$() is the list to place in the scroll window.
INFO$() is the scroll window's selections info-line data.
TL$ is the top line message for scroll windows with title boxes.
ENTRIES% is the number of items in LIST$().
KIND$ sets the type of scroll windows on entry to SCRLWIND.
"A"=autoexit "M"=multiple mark "S"=single mark
"V","SV"=view/single-mark view "L"=list only
Holds coded data for "mark" scroll windows on exit.
RTRN% sets the highlighted setection on entry. On exit, it
returns the sequential item selected from the scroll window.
LI% sets the interior row position the selected entry will occupy
on entry. On exit, it returns the row position occupied by
the highlighted entry.
FC% sets the offset from start of the strings ( entries ) to print
in the first column of virtual scroll window. On exit, it
returns the offset from the start of the strings ( entries )
occuping the first column in virtual scroll windows.
KEYATTR% is the color for the key characters. ( 0 to 127 )
0 = virtual scroll windows if any selections are
wider the the window's width minus 4.
1 to 127 = non-virtual scroll window
--------------------------------------------------------------------
4
Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
=====================================================================
Scroll Windows - cont.
=====================================================================
B4SCRL ( EXIT$, MARK$ )
Provides addition options for a subsequent call to SCRLWIND.
EXIT$ sets those keys or circumstances which will exit SCRLWIND.
( Any combination of "0123456789ERIDX" )
MARK$ allows selections in a scroll window to be marked on entry.
--------------------------------------------------------------------
5
Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
=====================================================================
Input Routines
=====================================================================
INPTINIT ( DATEFORMAT%, ISDOT%, EXIT$ )
Initializes input memory for routines INPTWIND an MULTINPT.
DATEFROMAT% sets the allowable date format. ( 1 to 5 )
ISDOT% equals 1 for a period decimal point, 0 for a comma.
EXIT$ sets the exit keys for routine INPTWIND and may equal
any combination of "0123456789UDER".
---------------------------------------------------------------------
INPTWIND (P$, CODE$, TR%, LC%, WD%, ATTR%, RES$, RTRN$, RKEY%, BRDR%)
Places an input window on the display. Waits for user input.
P$ is the prompt displayed for the input window.
CODE$ is the code for the type of allowable input.
TR% is the top row. ( 1 to 25 or 100 )
LC% is the left column. ( 1 to 79 or 100 )
WD% is the width of the input field.
ATTR% is the color for the input window.
RES$ restricts input to user defined characters.
RTRN$ is the text entered by the user in the input field.
RKEY% represents the "exit key". 1 to 13, 27
BRDR% is the border designation. (0-2, 10-12, 20-22, 30-32,
40-42, 100-102, 110-112, 120-122, 130-132, 140-142 )
--------------------------------------------------------------------
MULTINPT (SCRN%, TOFLD%, CODE$, AUTOEXIT%, RKEY%, RTRN$() )
Displays input fields and waits for user entry.
SCRN% is the assigned multi-field input screen to display.
TOFLD% is the active field when entering or exiting MULTINPT.
CODE$ is set to "VIEW" for view only, "U" to change several
field movement keys to follow user defined order.
AUTOEXIT% sets single field update on entry. Holds zero or
the the auto-exit field number which is being
exited when MULTINPT exits.
RKEY% holds the designation for the key which exited MULTINPT.
RTRN$() is the array holding each input field's data.
--------------------------------------------------------------------
RSTRINPT ( RESTOREFLAG% )
Deactivates the active input window optionally restoring the
display area under same.
RESTOREFLAG% is set to 1 to restore the display area under the
active input window, 0 to not restore it.
-------------------------------------------------------------------
6
Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
=====================================================================
Input Routines - Cont.
=====================================================================
SETINPT (SCRN%, COLWIDE%, EXIT$, INPT%(), INPT$(), ACTCOL%)
Set up routine for a multi-field input screen. ( MULTINPT )
SCRN% is the multi-field input screen designation. (1 - 10).
COLWIDE% is the display width for the multi-field input screen.
EXIT$ represents the allowable keys which will exit MULTINPT.
INPT%() is a array holding data for each input field type.
INPT$() is a array holding data for restricted input fields.
ACTCOL% is the active field's color. ( 0 to 255 )
--------------------------------------------------------------------
7
Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
=====================================================================
Directory Routines
=====================================================================
DISKSIZE (DRIVE%, SIZE&, FREE&)
Finds a disk size and free space in bytes.
DRIVE% represents the disk. 1=A, 2=B etc.
SIZE& is the total number of bytes of storage capacity.
FREE& is the unused bytes.
--------------------------------------------------------------------
FINDDIR (PATH$, TYP$. FILE%)
Places directory listing of any path in a pre-defined array.
PATH$ is the path to search for the directory listing.
TYP$ specifies file attributes to include in the directory search.
FILE% holds the number of files found in the directory search.
--------------------------------------------------------------------
FINDPATH (PATH$)
Returns the current path.
PATH$ is the current drive and path. ( DRIVE:\SUB-DIR.... )
--------------------------------------------------------------------
GETDISK (DRIVE%)
Returns the current ( default ) drive.
DRIVE% is the drive. 1=A, 2=B, etc.
--------------------------------------------------------------------
SETDISK (DRIVE%, BADFLAG%)
Sets the default drive.
DRIVE% is the drive. 1=A, 2=B, etc.
BADFLAG% = 1 if an attempt was made to set an invalid drive.
--------------------------------------------------------------------
8
Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
=====================================================================
Keyboard and Mouse Routines
=====================================================================
KEYMOUSE% ** FUNCTION **
Returns the ASCII/IBM or extended value of the key or mouse button
pressed, or the value for mouse movement.
---------------------------------------------------------------------
MBUTTONS (LBUTTON%, RBUTTON%)
Defines the values for the left and right mouse buttons. These
are the values returned by function KEYMOUSE%
LBUTTON% is the value for the left mouse button. ( 1 to 255 )
RBUTTON% is the value for the right mouse button. ( 1 to 255 )
---------------------------------------------------------------------
MOUSEON (ISON%)
Turns the mouse on or off, or disables motion detection.
ISON% = 0 for mouse off, 1 for mouse on, 2 for no motion
detection.
---------------------------------------------------------------------
9
Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
=====================================================================
Info-line Routines
=====================================================================
INFOLINE ( ROW%, LC%, WD%, ATTR% )
Turns on the info-line. Saves the display area under same.
ROW% is the row position of the info-line. (1 to 25)
LC% is the left column position of the info-line (1 to 80)
WD% is the width of the info-line (1 to 80)
( LC% + WD% must equal less than 82 )
ATTR% is the info-line's color. (1 to 127)
---------------------------------------------------------------------
INFOFIXED ( FIXED$ )
Defines a fixed info-string, which prints on calls to PRINTINFO.
FIXED$ is the fixed info-string. It will print before any string
specified in PRINTINFO.
---------------------------------------------------------------------
PRINTINFO ( MESSAGE$ )
Prints a message in the info-line.
MESSAGE$ is the message. It is appended to the fixed info-string
if one exists.
---------------------------------------------------------------------
RSTRINFO ( OFFFLAG% )
Restores the display area under the info-line. Optionally turns
off the info-line.
OFFFLAG% is set to one to turn off the info-line, 0 to leave on.
---------------------------------------------------------------------
10
Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.
=====================================================================
Other Routines
=====================================================================
GETANS (PROMPT$, CHOICE$, ANS$, TR%, LC%, ATTR%, BRDR%)
Displays a windowed prompt. Waits for a single key user response.
PROMPT$ is the prompt to place in the get answer window.
CHOICE$ represents the allowable keys GETANS will recognize.
ANS$ sets the mode of operation for GETANS on entry. If ANS$ = ""
on entry GETANS exits as soon as a valid key is pressed. If
ANS$ equals any character the character is displayed on
entry. ENTER must be pressed to exit. On exit, ANS$ returns
the character (key) selected by the user.
TR% is the top row of the get answer window. ( 1 to 23 or 100 )
LC% is the left column of the get answer window.( 1 to 76 or 100 )
ATTR% is the color of the get answer window. ( 1 to 255 )
BRDR% is the border designation. (0-2, 10-12, 20-22, 30-32,
40-42, 100-102, 110-112, 120-122, 130-132, 140-142 )
--------------------------------------------------------------------
DOSOUND
Makes the default sound.
--------------------------------------------------------------------
11
Copyright(c) 1988-92 - By: CONNECT Software - All rights reserved.